home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
pc_board
/
usersec.zip
/
USERSEC.DOC
next >
Wrap
Text File
|
1991-09-29
|
4KB
|
94 lines
USERSEC v1.01
Copyright 1991 by Jay Caplan. All rights reserved worldwide.
This batch file utility for PCBoard v14.x and compatible systems will return
the security level of an online user as a DOS errorlevel. The program is
network aware, and opens all files in SHARE mode.
This utility was written to fulfill a need I had on my board where I wanted
a batch file to perform different actions based on the security level of a
user online. Since PCBoard v14.5x doesn't have real-time upload/download ratio
enforcement, I am using Geoffrey Sy's PCBFRE program in a batch file that's
used as a user logs on. However, I only want it run for regular users, not
everyone. I use this utility to bypass running PCBFRE if the user's security
level is higher than a regular user.
Using the program:
1) Copy USERSEC.EXE to the PCB home directory, like C:\PCB, or a directory on
the DOS PATH.
2) Call this program in a batch file used by your board, and test for the DOS
errorlevel returned. Remember to test for the HIGHEST errorlevels FIRST.
3) PCBOARD.SYS must be in the default directory when the program is run.
4) The program accepts one OPTIONAL parameter. You may specify the fully
qualified path/filename to the USERS file.
Example: "USERSEC C:\PCB\MAIN\USERS"
If you specify the location of the USERS file, then the program will operate
faster, because it doesn't have to go looking for this file. If you don't,
then it will open the PCBOARD.DAT file to find out where USERS file is.
If the program experiences any errors, it will return with a DOS errorlevel
of 1. Possible error messages are:
a) "PCBOARD.SYS not found in default directory, aborting."
b) " 'user-specified USERS file' not found. Will try using PCBOARD.DAT to
locate USERS file." The actual name you gave will be quoted above.
c) "PCBOARD.DAT not found in default directory, aborting."
d) "Unable to access PCBOARD.DAT, aborting." This is possible if used in a
network/multitasking situation and another process has the file opened in a
mode that denies read access. This is unlikely, unless you use other PCBoard
utilities that access PCBOARD.DAT and are network dumb.
e) "Unable to access PCBOARD.SYS, aborting." See reasons above. No other
process should be accessing this node's PCBOARD.SYS, so this is a very
unlikely error.
f) "Unable to access USERS file, aborting." This is possible in
network/multitasking situations, if another process has the USERS file opened
in a mode that denies read access. This should NOT happen. Any network aware
program that accesses the USERS file while the board is up should only do
record locking at most, not file locking, which could generate this error. And
no other process should be locking the user's record for this node. So, I
consider this an unlikely error.
Terms of use and disclaimer:
This program (USERSEC.EXE) is Copyrighted 1991 by Jay Caplan. All rights
reserved worldwide. You are given permission to freely use, copy, and
distribute this program, under the following conditions: you do NOT charge
any money for copying or distributing it, you do NOT include ANY other
files within the distribution archive (including any BBS ad files), that
you always keep the program and documentation (USERSEC.EXE and
USERSEC.DOC) together whenever you distribute it, and that you do NOT in
ANY way modify the program or its documentation file.
This program is being made available on an "AS IS" basis. You use this program
AT YOUR OWN RISK. You assume FULL and COMPLETE responsibility and liability for
its use. I do NOT guarantee that it will work correctly for you. By running
this program, you are agreeing to these terms.
Contacting the author:
You may contact me (Jay Caplan) on my board, The Consultant BBS at 718-837-3236,
or leave E-mail for me on Compuserve to user-ID # 70421,17.
PCBoard is a registered trademark of Clark Development Company, Inc.
Qmail is copyrighted by Sparkware, Inc.
PCBFRE is copyrighted by Geoffrey Sy.